home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Programming / vahunz / vahunz.readme < prev    next >
Encoding:
Text File  |  2001-04-17  |  2.5 KB  |  103 lines
  1. TITLE
  2.  
  3.   vahunz - Make source code un-/more legible.
  4.  
  5. VERSION 
  6.  
  7.   1.7
  8.  
  9. AUTHOR
  10.  
  11.   Thomas Aglassinger <agi@giga.or.at>
  12.  
  13. DESCRIPTION
  14.  
  15.   Vahunz is a CLI-based replace command that can replace many words
  16.   across several files with only one invocation.
  17.  
  18.   Normally the target words will be created randomly, turning
  19.   meaningful names into unlegible garbage. For example, a function
  20.   name like read_input_file() could be replaced by g7B() or something
  21.   as useless. Additionally, comments and indention can be removed.
  22.  
  23.   As an option, you can specify specific substitutes, so Vahunz can
  24.   also be applied in a non-destructive manner. This can be used to
  25.   replace inconsistent, too short or unlegible names by something more
  26.   meaningful. Among programmers, this process is known as "The Great
  27.   Renaming".
  28.  
  29.   An Amiga Installer script acting as frontend to the CLI command is
  30.   included, so most tasks can be performed without having to deal with
  31.   cryptic command line options.
  32.  
  33. FEATURES
  34.  
  35.   - Stores less/more legible copy in a different directory
  36.   - Supports C, C++ and Java
  37.   - Auto-detects programming language
  38.   - New names since last run are easy to see
  39.   - Names can easily be declared to be modified or left untouched;
  40.     for example, it makes no sense to replace printf().
  41.   - Words being part of comments or string constants are not replaced
  42.   - Fast, as internally names are stored in an AVL-tree
  43.   - Several options to back-trace problems in vahunzed code
  44.   - Includes a set of standard dictionaries for various environments
  45.   - Includes source code (vahunzed ANSI C)
  46.  
  47. NEW FEATURES
  48.  
  49.   - Fixed some bugs
  50.  
  51. SPECIAL REQUIREMENTS
  52.  
  53.   AmigaOS 2.04, 2MB of regular memory, 68020
  54.  
  55. AVAILABILITY
  56.  
  57.   - Every Aminet-mirror, file "dev/misc/vahunz.lha", for example:
  58.  
  59.     ftp://wuarchive.wustl.edu/pub/aminet/dev/misc/vahunz.lha
  60.  
  61.   - http://www.giga.or.at/~agi/vahunz/
  62.  
  63. PRICE
  64.  
  65.   Freeware.
  66.  
  67. DISTRIBUTABILITY
  68.  
  69.   Freely distributable as long the conditions described in the manual
  70.   are met.
  71.  
  72. EXAMPLE
  73.  
  74.   For example, one might have a code excerpt like this:
  75.  
  76.     int main(void)
  77.     {
  78.         while (sepp_age < 83)
  79.         {
  80.             grow_older(sepp_name, &sepp_age);
  81.             print_sepp();
  82.         }
  83.         printf("\n%s died.\n", sepp_name);
  84.         exit(EXIT_SUCCESS);
  85.     }
  86.  
  87.   After vahunzing, this is what it might look like:
  88.  
  89.     int main(void)
  90.     {
  91.     while (g8B < 83)
  92.     {
  93.     z3V(v6Z, &g8B);
  94.     f4V();
  95.     }
  96.     printf("\n%s died.\n", v6Z);
  97.     exit(EXIT_SUCCESS);
  98.     }
  99.  
  100.   As you can see, the internal names have been garbled, but the
  101.   symbols of the standard library are preserved.
  102.  
  103.